home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3n / getsockname.z / getsockname
Encoding:
Text File  |  2002-10-03  |  5.4 KB  |  132 lines

  1.  
  2.  
  3.  
  4. ggggeeeettttssssoooocccckkkknnnnaaaammmmeeee((((3333NNNN))))                                                ggggeeeettttssssoooocccckkkknnnnaaaammmmeeee((((3333NNNN))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _gggg_eeee_tttt_ssss_oooo_cccc_kkkk_nnnn_aaaa_mmmm_eeee - get socket name
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _iiii_nnnn_tttt _gggg_eeee_tttt_ssss_oooo_cccc_kkkk_nnnn_aaaa_mmmm_eeee_((((_iiii_nnnn_tttt _ssss_,,,, _cccc_aaaa_dddd_dddd_rrrr______tttt _nnnn_aaaa_mmmm_eeee_,,,, _iiii_nnnn_tttt _****_nnnn_aaaa_mmmm_eeee_llll_eeee_nnnn_))))_;;;;
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _gggg_eeee_tttt_ssss_oooo_cccc_kkkk_nnnn_aaaa_mmmm_eeee returns the current _n_a_m_e for socket _s.  The _n_a_m_e_l_e_n parameter
  16.      should be initialized to indicate the amount of space pointed to by _n_a_m_e.
  17.      On return it contains the actual size of the _n_a_m_e returned (in bytes).
  18.  
  19. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  20.      _0000 is returned if the call succeeds; _----_1111 if it fails.
  21.  
  22. EEEERRRRRRRROOOORRRRSSSS
  23.      The call succeeds unless:
  24.  
  25.      _EEEE_BBBB_AAAA_DDDD_FFFF               The argument _s is not a valid descriptor.
  26.  
  27.      _EEEE_NNNN_OOOO_TTTT_SSSS_OOOO_CCCC_KKKK            The argument _s is a file, not a socket.
  28.  
  29.      _EEEE_NNNN_OOOO_MMMM_EEEE_MMMM              There was insufficient user memory for the operation
  30.                          to complete.
  31.  
  32.      _EEEE_NNNN_OOOO_SSSS_RRRR               There were insufficient STREAMS resources available
  33.                          for the operation to complete.
  34.  
  35. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  36.      _bbbb_iiii_nnnn_dddd(3N), _gggg_eeee_tttt_pppp_eeee_eeee_rrrr_nnnn_aaaa_mmmm_eeee(3N), _ssss_oooo_cccc_kkkk_eeee_tttt(3N)
  37.  
  38. NNNNOOOOTTTTEEEESSSS
  39.      The type of address structure passed to _aaaa_cccc_cccc_eeee_pppp_tttt depends on the address
  40.      family.  UNIX domain sockets (address family _AAAA_FFFF______UUUU_NNNN_IIII_XXXX) require a
  41.      _ssss_oooo_cccc_kkkk_eeee_tttt_aaaa_dddd_dddd_rrrr______uuuu_nnnn structure as defined in _ssss_yyyy_ssss_////_uuuu_nnnn_...._hhhh; Internet domain sockets
  42.      (address family _AAAA_FFFF______IIII_NNNN_EEEE_TTTT) require a _ssss_oooo_cccc_kkkk_aaaa_dddd_dddd_rrrr______iiii_nnnn structure as defined in
  43.      _nnnn_eeee_tttt_iiii_nnnn_eeee_tttt_////_iiii_nnnn_...._hhhh.  Other address families may require other structures.  Use
  44.      the structure appropriate to the address family; cast the structure
  45.      address to a generic _cccc_aaaa_dddd_dddd_rrrr______tttt in the call to _gggg_eeee_tttt_ssss_oooo_cccc_kkkk_nnnn_aaaa_mmmm_eeee and pass the size
  46.      of the structure in the _n_a_m_e_l_e_n argument.
  47.  
  48.      The functionality of _gggg_eeee_tttt_ssss_oooo_cccc_kkkk_nnnn_aaaa_mmmm_eeee is provided by _tttt______gggg_eeee_tttt_nnnn_aaaa_mmmm_eeee in TLI.
  49.      _tttt______gggg_eeee_tttt_nnnn_aaaa_mmmm_eeee will be replaced in the next release of System V.
  50.  
  51.      The syntax for _tttt______gggg_eeee_tttt_nnnn_aaaa_mmmm_eeee is as follows:
  52.      _tttt______gggg_eeee_tttt_nnnn_aaaa_mmmm_eeee_((((_ffff_dddd_,,,, _nnnn_aaaa_mmmm_eeee_,,,, _tttt_yyyy_pppp_eeee_))))
  53.      _iiii_nnnn_tttt _ffff_dddd_;;;;
  54.      _ssss_tttt_rrrr_uuuu_cccc_tttt _nnnn_eeee_tttt_bbbb_uuuu_ffff _****_nnnn_aaaa_mmmm_eeee_;;;;
  55.      _rrrr_eeee_gggg_iiii_ssss_tttt_eeee_rrrr _iiii_nnnn_tttt _tttt_yyyy_pppp_eeee_;;;;
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                                                                         PPPPaaaaggggeeee 1111
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68. ggggeeeettttssssoooocccckkkknnnnaaaammmmeeee((((3333NNNN))))                                                ggggeeeettttssssoooocccckkkknnnnaaaammmmeeee((((3333NNNN))))
  69.  
  70.  
  71.  
  72.      If _t_y_p_e is equal to _LLLL_OOOO_CCCC_AAAA_LLLL_NNNN_AAAA_MMMM_EEEE, then the address of the local side of the
  73.      connection is returned; otherwise, the address of the remote side is
  74.      returned.
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                                                                         PPPPaaaaggggeeee 2222
  128.  
  129.  
  130.  
  131.